home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / COMMADIO / TAPCIS.LZH / TAPTRY.EXE / TAPDOC.9 < prev    next >
Text File  |  1991-12-16  |  15KB  |  489 lines
  1.  
  2.  
  3. ===========================================================================
  4. 9 - Other TAPCIS Features
  5. ===========================================================================
  6.  
  7. Time/Charges  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1
  8.  
  9. Multiple Parameter Files    . . . . . . . . . . . . . . . . . . . . . . 9-2
  10.  
  11. Script Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3
  12.    Login Scripts  . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
  13.    Weather Script . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
  14.    Upload Script  . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
  15.  
  16. Macros  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. TAPCIS(tm) Documentation Copyright (c) 1991, Support Group, Inc.
  61. 800-USA-GROUP, 301-387-4500
  62.  
  63. ===========================================================================
  64. Time/Charges
  65. ===========================================================================
  66.  
  67. The external accounting module can generate the usage statistics provided
  68. you have selected to Log Times on the <P>arameters screen. Press <$> from
  69. the main menu to start the time/charges function. You're first asked
  70. whether you want to change the rates. The default rates are those for use
  71. with a CompuServe network phone number. Rates are subject to change. Use
  72. <I>nteractive and GO RATES to obtain the current schedule.
  73.  
  74. If you are using an alternative connection or pay metered local service,
  75. change the rates to reflect those charges. Prime time is the day time rate.
  76. Standard time is evening and weekend. CompuServe keeps its own time record
  77. which you can access with the command GO BILLING. It is not detailed by
  78. forum as are the TAPCIS statistics.
  79.  
  80. Output appears only on the screen. You can use <PrtSc> to print each
  81. screen.
  82.  
  83. You can run the STATS.EXE program from DOS if you do not have sufficient
  84. memory to run it from within TAPCIS. You should run it from the same
  85. directory that contains your parameter file (PARAMS.CIS) and time log files
  86. (LOGmm-yy.CIS, where mm is the month and yy is the year).
  87.  
  88. STATS will estimate what your bill will be at the end of the month. Do not
  89. put too much stock in this since your usage will probably vary over the
  90. rest of the month-higher or lower. Also, TAPCIS does not know about
  91. surcharged services like Official Airline Guide, Executive News Service, or
  92. IQuest. Those charges will be in addition to the charges recorded by
  93. TAPCIS.
  94.  
  95. There are two categories that TAPCIS uses to record charges for
  96. "miscellaneous" usage. The OVERHEAD charge is for the time it takes to
  97. navigate from forum to forum and to login and logout. It also includes the
  98. "rounding" expense since CompuServe charges to the nearest minute.
  99.  
  100. TERMINAL charges are for all time spent interactive regardless of where
  101. that time is spent. Once you are interactive, you can freely navigate from
  102. place to place. TAPCIS logs all that time as a TERMINAL expense in the
  103. accounting.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122. TAPCIS                                         Other TAPCIS Features    9-1
  123.  
  124. ===========================================================================
  125. Multiple Parameter Files  
  126. ===========================================================================
  127.  
  128. TAPCIS supports up to 21 different PARAMS files. You use the <Alt-F>
  129. command from the main menu or forums selection screen. TAPCIS will show you
  130. information about your current PARAMS file and let you switch files or
  131. create a clone of the current one by pressing X. The name of the new file
  132. can be 1-3 letters or numbers. 
  133.  
  134. Each PARAMS.* file contains not only the list of forums but also your user
  135. ID, password, and all other settings from the P>arameters screen. Be sure
  136. to set up the main PARAMS.CIS file with your registration number, user id,
  137. and password and then use <Alt-F> and the <X> copy option to create new
  138. ones.
  139.  
  140. You can use an alternate PARAMS file to change forum sets, support more
  141. than 20 selected forums, or switch COM ports and modem for laptop use. For
  142. example, I have a PARAMS.NOV that has the Novell forums selected and that
  143. uses a different storage and download path than my "normal" PARAMS.CIS (the
  144. default name).
  145.  
  146. You can select the PARAMS file directly from the command line by using the
  147. /PARAMS= parameter:
  148.  
  149. TAPCIS /PARAMS=NOV
  150.  
  151. The above would start TAPCIS using the PARAMS.NOV file.
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183. 9-2    Other TAPCIS Features                                         TAPCIS
  184.  
  185. ===========================================================================
  186. Script Language
  187. ===========================================================================
  188.  
  189. The script language has three primary uses in TAPCIS:  customizing login
  190. scripts for access through non-CompuServe networks (e.g., Sprintnet,
  191. Tymnet, LATA networks, foreign networks), creating a FRONTEND.SCR to
  192. capture information like weather and the daily news to the CompuServe Mail
  193. message file, and simplifying the repetitive entry of commands in non-forum
  194. online services (e.g., stock portfolio analysis, weather radar map
  195. downloading, stock quotes).
  196.  
  197. The script commands are as follows. Each is a single capital letter or
  198. semicolon for comments. Most commands are followed by a space which
  199. delimits the commands from the parameter.
  200.  
  201. ;              Comment lines begin with a semi-colon and can appear
  202.                anywhere in the script.
  203.  
  204. B              Send a break signal. Used in login scripts where a <break>
  205.                is needed to get the network's attention.
  206.  
  207. C d:\path\filename.ext
  208.                Capture output and append it to "filename.ext" on drive "d:"
  209.                in directory "path." Includes an explicit C Y (see below).
  210.  
  211. C Y            Start (or restart) the capturing to the file specified with
  212.                the last C filename script command or to the MAIL.MSG if in
  213.                FRONTEND.SCR.
  214.  
  215. C N            Stop capturing output to the file.
  216.  
  217. E              Comment lines that display on the user's screen as the
  218.                script executes. They are not sent to CompuServe or saved to
  219.                any of the files.
  220.  
  221. I              Input from the keyboard until the user presses <F7>. This
  222.                script command is useful in login scripts to allow the user
  223.                to manually get connected to CompuServe. In interactive
  224.                scripts it can be used to allow the user to select a
  225.                particular menu choice after the script automatically
  226.                navigates to the menu. Output is saved to the ONLINE.LOG if
  227.                the G command line option is used or to the capture file if
  228.                one is active. Note that TAPCIS will not time out and logoff
  229.                during the I script command.
  230.  
  231. K d:\path\filename.ext
  232.                Kill (delete) the file "d:\path\filename.ext". If you have a
  233.                script that uses the capture command, and want to remove the
  234.                old capture if one exists, use the K command before the C
  235.                script command.
  236.  
  237. N              Sends your name from the parameters screen. Used in the
  238.                <Alt-P> script.
  239.  
  240. P nn           Pause for "nn" seconds
  241.  
  242.  
  243.  
  244. TAPCIS                                         Other TAPCIS Features    9-3
  245.  
  246. S text            Send "text" of any length. Most commands on most services
  247.                   must be followed by an <Enter>. In these cases end the "S
  248.                   " command with caret-M <^> <M>. The caret key can be com-
  249.                   bined with any alphabetic key to duplicate a control
  250.                   code. For example, ^C is ctrl-C. Control codes must be in
  251.                   uppercase! This command waits for an echo of what is sent
  252.                   before continuing.
  253.  
  254. U text            This command also sends "text" of any length. However, it
  255.                   does not wait for an echo of the characters sent before
  256.                   continuing. This is useful for login scripts to networks
  257.                   where the first few characters sent may not echo or echo
  258.                   correctly.
  259.  
  260. W x               Wait for a single character "x" before continuing.
  261.  
  262. W xxxx            Wait for a four character sequence "xxxx" before
  263.                   continuing. Use a full four characters. Using 2-3 may
  264.                   cause the script to fail.
  265.  
  266. X                 Same as C N. You should start using C N instead of X.
  267.  
  268.  
  269. ------------------------------------
  270. Login Scripts
  271.  
  272. You can have a user defined login script by putting an underscore < _ >
  273. after the phone number on the <P>arameters screen. An underscore alone
  274. tells TAPCIS to use the script in TAPCIS.SCR. You can put the script
  275. filename (without the extension) after the underscore to use a specific
  276. script (i.e., 555-1212_MYSCRIPT). If you are going to write your own
  277. scripts, you should look at supplied scripts as an example of how to put
  278. one together. Scripts must be in ASCII format. Here is a simple script for
  279. login through a CompuServe node.
  280.  
  281. ; CIS.SCR -- Login using <CR> for Picky PADs that don't like
  282. ; ^C's.
  283. ; 5.4 version 10/20/91 -rpw
  284. E TAPCIS LOGIN SCRIPT
  285. E Login Through CompuServe Node where ^C is not being recognized
  286. P 3
  287. U ^M
  288. W ame:
  289. S CIS^M
  290.  
  291. A script for a standard LATA Network (usually run by your local phone
  292. company) has been provided in the file LATANET.SCR. You select this script
  293. by placing a colon <:> after the phone number. One problem: LATA Networks
  294. are not standard!  If you are going to use a LATA network, you may have to
  295. modify the supplied script to work with the connect sequence required by
  296. your LATANet.
  297.  
  298. Many non-CompuServe networks require that you start TAPCIS with the P
  299. command line option. When in doubt, you can use the P option with any
  300. network without causing any problems.
  301.  
  302.  
  303.  
  304.  
  305. 9-4    Other TAPCIS Features                                         TAPCIS
  306.  
  307. ------------------------------------
  308. Weather Script
  309.  
  310. Here is a script that will capture today's weather in the file TODAY.WEA.
  311. It deletes the old copy of the file before capturing the new information:
  312.  
  313.  
  314. ; WEA.SCR - Capture today's weather to TODAY.WEA 
  315. ; 
  316. ; To invoke the script, go online to CIS <Interactive>, make sure
  317. ; you're on a 
  318. ; CompuServe prompt (like in the forums, or at a CIS menu). If in
  319. ; doubt, 
  320. ; type GO CIS, then press <PgUp> then type WEA and press return 
  321. ; 
  322. ; Send the WEAther command.
  323. ; If you want the weather at a different city that has weather
  324. ; reporting, 
  325. ; type the full city and state after WEA
  326. S WEA Columbus, OH^M 
  327. ; Kill the old weather report 
  328. K TODAY.WEA 
  329. ; Open the capture file 
  330. C TODAY.WEA 
  331. ; Wait for the next prompt 
  332. W !
  333. ; Close the capture file 
  334. C N
  335. ; Send carriage return to get back to prompt 
  336. S ^M 
  337.  
  338.  
  339. ------------------------------------
  340. Upload Script
  341.  
  342. Here is a simple script which uploads a file to a LIB. You should use
  343. caution when writing and testing such scripts!  As you can see the upload
  344. script is really just a sequence of send a command and wait for the next
  345. prompt. You can invoke such a script from within a forum by pressing <PgUp>
  346. followed by the name of the file. Your script file must have a file
  347. extension .SCR.
  348.  
  349. ; UPL.SCR -- Upload a file to a forum library. Version 5.4 10/20/91 RPW 
  350. ; 
  351. ; Instructions for use: 
  352. ; Change the forum name, library number, file name in the UPL
  353. ;  command, filename on your computer, the file description (keep
  354. ;  it fewer than 549 characters), and the keywords. 
  355. ; Forum to receive the file (change!): 
  356. S G forum_name_here^M 
  357. ; Wait for Forum ! prompt 
  358. W um ! 
  359. ; 
  360. ; Library to receive the file (change!): 
  361. S LIB library_number_here^M 
  362. W ! 
  363. ; 
  364.  
  365.  
  366. TAPCIS                                         Other TAPCIS Features    9-5
  367.  
  368. ; Filename to use on CompuServe (change!) 
  369. ; and file type (ASC or BIN -- change!): 
  370. S UPL filename_here/PRO:B/TYP:asc_or_bin_here^M 
  371. W ter: 
  372. ; 
  373. ; Filename on your computer including path if necessary (change!)
  374. S filename_on_your_computer_here^M 
  375. ; Upload takes place here. Then wait for 'finished:'
  376. W hed:
  377. ; 
  378. ; File description (change!). Be sure to keep the ^M's at the end
  379. ;  of lines! 
  380. S In a circular sort of way, this is a file that was uploaded^M
  381. S using itself. UPL.SCR will permit you to upload any file^M
  382. S anywhere on CompuServe. Edit it so that the Lib and Forums^M
  383. S are correct and then go online <I>nteractive selecting no^M
  384. S Forum. At the first prompt, hit <PgUp> and then enter UPL.^M
  385. S Two rules -- 549 char max and no blank lines in this DES^M
  386. S area.^M 
  387. ; 
  388. ; Exit the description 
  389. S /EXIT^M 
  390. ; Wait for "P ):" in "Enter Keywords ( or type "?" for HELP ):"
  391. W rds: 
  392. ; 
  393. ; Keywords for the file (change!) 
  394. S keywords_go_here^M 
  395. ; Wait for "ed):" in "Enter Title (up to 49 chars, <CR> when
  396. ;  finished):"
  397. W tle:
  398. S title_goes_here^M
  399. ; next line is <space>N)? in 'Is this okay (Y or N)?'
  400. W  N)? 
  401. S Y^M 
  402. W ! 
  403. ; Logoff 
  404. S OFF^M
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427. 9-6    Other TAPCIS Features                                         TAPCIS
  428.  
  429. ===========================================================================
  430. Macros
  431. ===========================================================================
  432.  
  433. TAPCIS supports 40 macros, 20 when online interactive and 20 when editing
  434. in the message editor. You can define the macros by pressing <Alt-M> from
  435. the main menu and selecting either <E>ditor or <O>nline macros. 
  436.  
  437. Next press the letter you want to assign to your macros (A through T only)
  438. and enter the text for the macro. Use the vertical bar (|) for carriage
  439. returns. No other special control codes are supported (e.g., no tabs).
  440.  
  441. Then when in the editor or online, press <Alt-M>. A list of the macros will
  442. appear. Press the corresponding letter and your macro will be passed to the
  443. editor or CompuServe.
  444.  
  445. Note that when online, two macros have been programmed specifically to help
  446. you use CompuServe interactively. <Alt-M> <X> sets CompuServe to verbose
  447. menu mode with a screen size of 23 lines. <Alt-M> <Y> sets an individual
  448. forum to menu mode and pausing after each message. Both these macros affect
  449. only the current session. Macros are not available offline except in the
  450. editor. 
  451.  
  452. You can use macros for your standard closing for a message in the editor,
  453. or for conference or CompuServe commands when in interactive mode. In
  454. Conference Mode you can have a macro that would get a list of participants
  455. by defining it as:  "/UST|". 
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488. TAPCIS                                         Other TAPCIS Features    9-7
  489.